home *** CD-ROM | disk | FTP | other *** search
/ QuickTime 2.0 Developer Kit / QuickTime 2.0 Developer Kit.iso / mac / MAC / Utilities / ShrinkWrap™ 1.1 / ShrinkWrap™ Read Me next >
Encoding:
Text File  |  1994-09-07  |  19.5 KB  |  283 lines  |  [ttro/ttxt]

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. A drag and drop utility for Apple disk images.
  10. Copyright ©1994, by Chad Magendanz
  11.  
  12. Version 1.1 - 6 Aug 1994
  13.  
  14. Description
  15. -----------
  16. ShrinkWrap™ was created for four basic purposes:
  17.  
  18. 1.  To create DiskCopy™ disk images quickly and efficiently:
  19. Using ShrinkWrap™, you can create DiskCopy™ disk images by simply dragging and dropping your floppy drive icons onto the ShrinkWrap™ icon. 
  20.  
  21. 2.  To provide a convenient and reliable means of mounting multiple disk images on the desktop: 
  22. Like Apple's MountImage™ control panel, ShrinkWrap™ will mount image files on the desktop that to the system will appear identical to the original floppy disks.  However, since ShrinkWrap™ is an application, it will never cause INIT conflicts and will never require any memory until it's actually run.  To mount image files, simply drag and drop the image file icons onto the ShrinkWrap™ icon.  Image files can even be mounted as unlocked disks by holding down the Option key during launch.
  23.  
  24. 3.  To seamlessly handle image files in their archived form:
  25. ShrinkWrap™ will automatically compress and decompress archived image files on-the-fly with Aladdin's StuffIt Engine™.  Now that the StuffIt Engine™ has been released as shareware with the DropStuff with Expander Enhancer package, you don't have to own StuffIt Deluxe™ to take advantage of these convenient compression features.
  26.  
  27. 4.  To provide a freely distributable alternative to Apple's DiskCopy™, DART™ and MountImage™:
  28. These products cannot yet legally be licensed for redistribution.  Apple Computer, Inc. is working to create a license, but until that time, you may not legally redistribute it once you receive a copy from an authorized Apple source.
  29.  
  30. Version History
  31. ---------------
  32. Version 1.1 -    6 Aug 1994
  33.  - Full DART support (read, convert & mount).
  34.  - Includes MungeImage 1.2 image driver which compresses read-only images in memory.
  35.  - Copies image files back to floppy disk.
  36.  - Copies images disk-to-disk.
  37.  - Extensive image file verification options.
  38.  - Prettier and smoother progress box.
  39.  - Eliminated temporary folder while decompressing image archives.
  40.  
  41. Version 1.0 -  31 July 1994     Initial Release
  42.  
  43.  
  44. Installation
  45. ------------
  46. Install ShrinkWrap™ by double-clicking the self-expanding archive and dragging the ShrinkWrap™ application to a convenient location on your hard drive.  You may need to rebuild your desktop if ShrinkWrap™ will not initially accept drag and drop files.  Hopefully, you already have the StuffIt Engine™ installed in your System Extensions folder.  If not, you should obtain Aladdin's StuffIt Expander and DropStuff with Expander Enhancer and install the software.
  47.  
  48. System Requirements
  49. -------------------
  50. ShrinkWrap™ is a System 7-only application.  It is AppleEvent aware, 32-bit clean, Power Macintosh, AV, ’040 cache and virtual memory compatible. 
  51.  
  52. Why do we need to deal with disk images?
  53. ----------------------------------------
  54. Although there is some similarity between disks duplicated from disk images and disks copied by dragging icons, the results are not identical. Floppy disks created from image files are exact duplicates, including the exact icon placement, appearance of all windows, and the correct name of the disk. In addition, with disk images you have the added assurance that all the files have been duplicated correctly and completely.  More importantly, Apple's Installer will not recognize disks copied by dragging icons, even if they appear identical in every way.
  55.  
  56. Some convenient uses for disk images:
  57. -------------------------------------
  58. 1.  Backing up your original floppy disks to removable media:
  59. A Magneto-Optical or SyQuest drive can serve as an excellent means to back up your software.  When disk image files are stored in compressed form, they are space efficient but still easily accessible with ShrinkWrap™.  Just drag the compressed image onto the ShrinkWrap™ icon and the file will be uncompressed and immediately mounted on the desktop. 
  60.  
  61. 2.  Installing Apple's System Updates and System Software Extensions:
  62. Since most of Apple's System Software, System Updates and System Extensions (CD-ROM Setup, Network System Installer, printer drivers, etc.) are distributed over the net in image file format, it would be convenient to be able to mount the images and run the Installer without ever having to copy the images back to floppy disk.  Unfortunately,  MountImage™ has a serious bug that causes data corruption when installing from mounted disk images.  ShrinkWrap™ does not suffer from this problem.
  63.  
  64. 3.  Distributing multiple disk images on floppies:
  65. Using ShrinkWrap™ and the StuffIt Engine™, you can achieve adequate compression to store three or more 800K disk images on a 1.44 MB HD floppy.
  66.  
  67. 4.  Mounting HD floppies on older Macs without a SuperDrive™:
  68. For older Macs not equipped with a SuperDrive™, ShrinkWrap™ provides a cost-effective and convenient means of mounting HD floppies on the desktop.
  69.  
  70.  
  71. Using ShrinkWrap™
  72. =================
  73.  
  74. Mount Image File:
  75. -----------------
  76. DART, DiskCopy™ and ShrinkWrap™ image files can be mounted by dragging their icons onto the ShrinkWrap™ icon:
  77. 1. In the Finder, select one or more image files that you want mounted.
  78. 2. Drag them over the ShrinkWrap™ icon until it is highlighted.
  79. 3. Let go of the mouse/trackball button.
  80. ShrinkWrap™ will open and you’ll see a progress box. When everything is mounted, ShrinkWrap™ automatically quits. 
  81.  
  82. >> Note: When mounting disk images via drag and drop, you can mount the image files as an unlocked disks by holding down the Option key as ShrinkWrap™ launches. <<
  83.  
  84. If you prefer a “manual” way to mount image files:
  85. 1. Double click the ShrinkWrap™ icon to open the application.
  86. 2. Choose the “Mount Image File...” command from the File menu.
  87. 3. Select the desired image file to mount in the standard file dialog.
  88. 4. Check the Mount as Unlocked Disk option if you desire read/write access to the mounted image file.  (Note that the image cannot be compressed in memory if you select this option.)
  89.  
  90. Unmount Image File:
  91. -------------------
  92. Image files can be unmounted in the Finder by dragging one or more mounted image file icons to the Trash.
  93.  
  94. To unmount image files from within the ShrinkWrap™ application:
  95. 1. Choose “Unmount Image File...” from the File menu.
  96. 2. Select the disk image volume to unmount using the standard file dialog.
  97.  
  98. >> Caution: Do NOT eject a mounted image file.  It is very difficult to “reinsert” an ejected disk image file when the system requests it later. <<
  99.  
  100. >> Note: If this happens to you, press Command-. to cancel the reinsert requests. <<
  101.  
  102. Create Image File:
  103. ------------------
  104. Image files can be made of floppy disks by dragging their icons onto the ShrinkWrap™ icon:
  105. 1. In the Finder, select one or more floppy disks that you want copied.
  106. 2. Drag them over the ShrinkWrap™ icon until it is highlighted.
  107. 3. Let go of the mouse/trackball button.
  108. ShrinkWrap™ will open and you’ll see a progress box. When all the disks have been read and image files saved to the destination folder, ShrinkWrap™ automatically quits. 
  109.  
  110. To create image files from within the ShrinkWrap™ application:
  111. 1. Choose the “Create Disk Image...” command from the File menu.
  112. 2. Select the floppy disk volume to copy using the standard file dialog.
  113.  
  114. Copy Image File to Disk:
  115. ------------------------
  116. Image files can be copied back to floppy disk by dragging their icons onto the ShrinkWrap™ icon while holding down the Command key:
  117. 1. In the Finder, select one or more image files that you want copied to disk.
  118. 2. Drag them over the ShrinkWrap™ icon until it is highlighted.
  119. 3. While holding down the Command key, let go of the mouse/trackball button.
  120. ShrinkWrap™ will open and you’ll see a progress box.  At this point you may release the Command key.  When each disk image has been read and checksums verified, you will be prompted to insert a unlocked destination disk into any floppy drive.
  121.  
  122. >> Caution: The unlocked floppy disk that you insert will be totally overwritten with the contents of the image file. <<
  123.  
  124. If the Multiple Copies option was enabled in the Preferences dialog, you will be prompted to enter another disk when the first copy is complete.  Press Stop when you wish to make no more copies and ShrinkWrap™ will go on to the next image file in the queue.
  125.  
  126. To copy image files to disk from within the ShrinkWrap™ application:
  127. 1. Choose the “Copy Image File to Disk...” command from the File menu.
  128. 2. Select the image file to copy using the standard file dialog.
  129.  
  130. Duplicate Disk:
  131. ---------------
  132. Floppy disks can be duplicated by dragging their icons onto the ShrinkWrap™ icon while holding down the Command key:
  133. 1. In the Finder, select a floppy disk that you wish to duplicate.
  134. 2. Drag its icon over the ShrinkWrap™ icon until it is highlighted.
  135. 3. While holding down the Command key, let go of the mouse/trackball button.
  136. ShrinkWrap™ will open and you’ll see a progress box.  At this point you may release the Command key.  When the original disk image has been read and checksums calculated, it will be ejected and you will be prompted to insert a unlocked destination disk into any floppy drive.
  137.  
  138. >> Caution: The unlocked floppy disk that you insert will be totally overwritten with the contents of the original floppy disk. <<
  139.  
  140. If the Multiple Copies option was enabled in the Preferences dialog, you will be prompted to enter another disk when the first copy is complete.  Press Stop when you wish to make no more copies.
  141.  
  142. To duplicate disks from within the ShrinkWrap™ application:
  143. 1. Choose the “Duplicate Disk...” command from the File menu.
  144. 2. Select the floppy disk volume to duplicate using the standard file dialog.
  145.  
  146. Convert Image File:
  147. -------------------
  148. DART™, DiskCopy™ or ShrinkWrap™ image files can be converted to the format specified in the Preference dialog by dragging their icons onto the ShrinkWrap™ icon while holding down the Control key:
  149. 1. In the Finder, select one or more image files that you want to convert.
  150. 2. Drag them over the ShrinkWrap™ icon until it is highlighted.
  151. 3. While holding down the Control key, let go of the mouse/trackball button.
  152. ShrinkWrap™ will open and you’ll see a progress box.  At this point you may release the Control key.  When each disk image has been converted and checksums verified, ShrinkWrap™ will automatically quit.
  153.  
  154. To convert image files from within the ShrinkWrap™ application:
  155. 1. Choose the “Convert Image File...” command from the File menu.
  156. 2. Select the image file to convert using the standard file dialog.
  157.  
  158. Verify Image File:
  159. ------------------
  160. To verify image files from within the ShrinkWrap™ application:
  161. 1. Choose “Verify Image File...” from the File menu.
  162. 2. Select the image file to unmount using the standard file dialog.
  163.  
  164. Here are some details about the Preferences dialog:
  165. ---------------------------------------------------
  166. 1. The group of three “Destination:” radio buttons indicate where the image files and StuffIt™ archives created by ShrinkWrap™ should be stored.  Selecting “Same as ShrinkWrap™” will use the folder where the running ShrinkWrap™ application currently resides.  Selecting “Prompt for destination” will prompt you for a destination with a standard file dialog at runtime.  Finally, selecting “Use:” will allow you to specify a folder of your choice.  Note that you should always choose your destination folder to be located on an unlocked volume with plenty of free disk space.
  167.  
  168. 2. The “Select” button allows you to chose a specific folder as the destination folder.  If ShrinkWrap™ for some reason can't find this folder on startup, it will default to the startup volume desktop folder.
  169.  
  170. 3. Selecting the “Save as DiskCopy™ image files” check box will cause ShrinkWrap™ to create disk images with DiskCopy™'s creator signature.  This may seem unimportant, since the files will be identical in every other way, but DiskCopy™ rather arrogantly refuses to use Apple disk images created by any other application but itself.
  171.  
  172. >> Note: If you intend to use DiskCopy™ to copy ShrinkWrap™ disk images back to floppies, be sure “Save as DiskCopy™ image files” is checked. <<
  173.  
  174. There are advantages to saving a disk image with ShrinkWrap™'s creator signature, though:
  175.  
  176.   a. ShrinkWrap™ image files will be instantly mountable by just double-clicking the image file icon.
  177.  
  178.   b. ShrinkWrap™ image files get a cool new icon with racing stripes in the upper-left hand corner.
  179.  
  180.   c. DiskCopy™ image files will be stuck with a generic icon if a copy of DiskCopy™ is not located somewhere on the destination disk.
  181.  
  182. 4. Checking the “Automatically expand StuffIt™ archives” check box will cause StuffIt archives (and StuffIt self-extracting archives) to be automatically UnStuffed, then the resulting image file to be mounted.
  183.  
  184. 5. Checking the “Delete archive after expanding” check box deletes the image file archive from the disk after it has been UnStuffed into its original image file.  Use this feature carefully.
  185.  
  186. 6. Checking the “Automatically Stuff™ image files” check box will cause all image files created with ShrinkWrap™ to be automatically compressed into their own StuffIt™ archive.
  187.  
  188. 7. Checking the “Delete original after compressing” check box deletes the original image file from the disk after it has been Stuffed into an archive.
  189.  
  190. 8. Checking the “Verify destination disk checksums” check box will provide an additional verification pass when copying image files to disk or conducting disk-to-disk copies to verify that checksums on the destination disk match the original.  This verification pass is in addition to sector-by-sector verification already done by the driver.
  191.  
  192. 9. Checking the “Multiple disk copy” check box will allow you to sequentially enter destination disks when copying image files to disk or conducting disk-to-disk copies without having to re-read the original image for each disk.
  193.  
  194.  
  195. Important Tips:
  196. ===============
  197.  
  198. Make sure you have enough available RAM:
  199. ----------------------------------------
  200. 1. ShrinkWrap™ 1.1 uses Quinn & Peter Lewis's MungeImage™ 1.2 driver to mount image files.  This driver is fairly well established and much more stable than MountImage™.  Basically, MungeImage™ mounts disk images by creating a RAM disk the size of the floppy, then copying the contents of the image file to the RAM disk.  This is a very solid practice that effectively avoids data corruption problems since it doesn't need to access the File Manager from the driver level.  However, to mount an image file using the MungeImage™ driver, you should always have as much free RAM as disk capacity you wish to mount.  Virtual memory doesn't count.  With version 1.2 of MungeImage, read-only ShrinkWrap™ and DiskCopy™ images are compressed when they are mounted to reduce the actual memory footprint, but you never know what kind of compression ratio you will get.
  201.  
  202. 2. The system heap will expand when memory blocks are allocated to the MungeImage™ driver to mount disk images.  When you unmount disk images, the corresponding memory is freed.  However, the system will not compact and resize the system heap until the free memory is required by another application.
  203.  
  204. 3. ShrinkWrap™ has a minimum memory partition of 1600K because 1440K is required as a buffer while reading HD drives.  If you set the memory partition to less than the minimum, the application can still function.  In fact, if available RAM is really tight and you need to mount just one more image, you can set the memory partition down to about 100K and still be able to mount images.  However, be prepared for an out of memory error if you attempt to create or copy a disk image.
  205.  
  206. Anti-Viral Utilities:
  207. ---------------------
  208. Some anti-viral utilities may consider ShrinkWrap™'s activities to be “suspicious” in nature and will stop processing to warn you of some events.  If this happens to you, I recommend switching to a less invasive anti-viral utility like John Norstad's Disinfectant.
  209.  
  210. MFS Disks:
  211. ----------
  212. ShrinkWrap™ is unable to create image files of Mac 400K disks due to restrictions on MFS disks introduced with System 7.  All other features, however, are fully supported with disks of this type.
  213.  
  214. Accelerator Cards:
  215. ------------------
  216. ShrinkWrap™ will not run with some Radius and Daystar accelerator cards.  Unfortunately, most of these are incompatible with DiskCopy™ as well.  If this is your situation, I recommend trying DART™, Norton Floppier™ or MacTools FastCopy™.
  217.  
  218. Older Macs:
  219. -----------
  220. Some older Macs (pre-IIci and 68K models) will be unable to copy disk images back to floppy disk with ShrinkWrap™ since their floppy disk drivers do not support the necessary control calls.  I apologize to these low-end users, but by using the advanced calls I was able to eliminate the need for separate format, verify, write, and write-verify passes.  The performance gain for the overwhelming majority of users was just too great to warrant doing it the old-fashioned way.  I'll try to work out a solution for older Macs in a future version.
  221.  
  222. Performance Comparison:
  223. =======================
  224. Here is a rough comparison of speed and compression algorithm efficiency for DART™ 1.5.3, DiskCopy™ 5.0d1, DiskDup+ 2.5.1 and ShrinkWrap™.  I used a Quadra 610 16/230 running System 7.1 to create normal and compressed disk images of a single 1440K floppy.  (My representative floppy was Apple's Software Update 3.0 Disk 1.)
  225.  
  226. DART™ 1.5.3         Fast          Best
  227. -----------         ----          ----
  228.   Time              1:14          3:22
  229.   Image Size        968K          732K
  230.  
  231. DiskCopy™ 5.0d1   Normal    Compressed
  232. ---------------   ------    ----------
  233.   Time              0:43          0:55
  234.   Image Size       1.4MB          952K
  235.  
  236. DiskDup+ 2.5.1    Normal    Compressed
  237. --------------    ------    ----------
  238.   Time              0:49           N/A
  239.   Image Size       1.4MB           N/A
  240.  
  241. ShrinkWrap™       Normal    Compressed
  242. -----------       ------    ----------
  243.   Time              0:37          1:03
  244.   Image Size       1.4MB          708K
  245.  
  246. This was certainly not an exhaustive test, but you can see some clearly better performers.  If you are using an image utility program to backup original floppies to removable media like a SyQuest or Magneto-Optical drive, the difference of a few minutes or a few hundred kilobytes per disk
  247. adds up quickly.
  248.  
  249. ShrinkWrap™ is Freeware
  250. =======================
  251. Freeware is software freely distributed via local bulletin board systems (BBS), commercial on-line services, user groups, and between friends.  You are allowed to use freeware as much as you like for as long as you like, as long as you say good things about the author.  I ask for no monetary compensation.  (I would only use the dough to pay for wasteful things like volumes of Inside Macintosh and PowerPC compilers.)
  252.  
  253. Please share this software with every Mac user you know!
  254.  
  255. Keep in mind, however, that ShrinkWrap™ is still copyrighted and that you do not have the right to sell or alter it in any way without my written consent.  I also will not be liable for any damages, including lost of data, lost profits, cost of cover or other special, incidental, consequential or indirect damages arising from the use of this program.
  256.  
  257.  
  258. In Planning for Future Versions
  259. ===============================
  260. 1. Creating self-mounting, self-extracting archives.
  261. 2. Expanding other archive formats supported by the StuffIt Engine™ (i.e. .hqx, .cpt, .zip)
  262. 3. Support for DiskDup+, Norton Floppier™ and MacTools FastCopy™ image file formats.
  263. 4. Extending AppleEvent support beyond the core suite.
  264. 5. Mounting new image files.
  265. 6. Mounting folders.
  266. 7. Full support for older Macs.
  267. 8. More graceful handling of Eject.
  268. 9. PowerPC native code.
  269.  
  270.  
  271. Contacting the Author
  272. =====================
  273. If you would like to obtain the latest version of ShrinkWrap™, suggest new features, or complain about a bug, just contact me at:
  274.  
  275. E-mail:
  276.  Internet: chad@halcyon.com
  277.  America Online: Magendanz
  278.  
  279. Address:
  280.  Chad Magendanz
  281.  4415 NE 5th, Apt. G104
  282.  Renton, WA 98059 USA
  283.